home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 3 / BBS in a box - Trilogy III.iso / Files / Tele / I-L / Informant Folder / informant Read Me < prev   
Encoding:
Text File  |  1990-04-12  |  9.8 KB  |  213 lines  |  [TEXT/QED1]
  1. informant version 1.00
  2. Copyright © 1990 Chriss Koch.  All rights reserved.
  3.  
  4. informant is a Tabby event compatible utility which can automatically post an
  5. echomail message.  informant was written in THINK C by Chriss Koch (some
  6. portions copyright THINK C and Michael Connick).  informant is shareware.  If
  7. you use this software please send $5 to the author.  This software may not be
  8. distributed commercially.  Please include this “Read Me” file when
  9. redistributing this software.
  10.  
  11.  
  12. • USES •
  13. Most likely you already have an idea how you want to use this utility. In case
  14. you don't, I'll explain one of the ways I use it.
  15.  
  16. I participate in a Fidonet echo named MACFILES.  The topic (or purpose) of
  17. this echo is to notify participating Fidonet sysops of new Macintosh files
  18. that are available for File Request (FREQ).  Daily I create a TEXT file
  19. listing of any new files on my BBS.  informant takes this file, and creates a
  20. message to be imported to your BBS message base (via Generic Import) and
  21. exported to the net (via Generic Export).
  22.  
  23. informant is Tabby event compatible, which means that it can run unattended
  24. during any Tabby event.  informant can also be operated outside of the Tabby
  25. event.
  26.  
  27.  
  28. • SETUP •
  29. informant must reside in the same folder as your BBS and Tabby programs.  It
  30. expects to find a Tabby file named “Generic” in this same folder.  The Generic
  31. file contains the pathname to your Generic Import and Generic Export files. If
  32. you would like informant to run during a Tabby event you will need to edit any
  33. of your Tabby event chains where you would like it to run. To configure
  34. informant, triple click the application’s icon (double click to launch, then
  35. click and hold the mouse button while informant is launching). You will be
  36. presented with a modal dialog containing fields which you may edit to
  37. customize informant’s operation.  These are the parameters:
  38.  
  39. day - this tells informant on which day it should do it’s thing. This field
  40. should contain a number corresponding to the day of the week you want
  41. informant to create it's output file.  You may enter any number from 0 to 7 in
  42. this field.  If there is a 0 in this first field, informant will attempt to
  43. create an output file every time it is run (providing there is a data file
  44. present).  Entering a number from 1 to 7 will cause informant to attempt to
  45. create an output file only one day a week (1 = Sunday, 7 = Saturday).
  46.  
  47. msg base # - the second field contains the category number for the echomail
  48. conference where informant will post it’s message. The number corresponds to
  49. the Echomail Area category number specified by the Tabby Maint program and
  50. contained in the “areas.bbs” Tabby file. This field will always be three
  51. digits in length and will have leading zeros if the number is less than 3
  52. digits.  For example, on my BBS, informant posts a message into the MACFILES
  53. echomail conference.  On my BBS, the corresponding category number is “18”,
  54. but I need to enter “018” in this field.
  55.  
  56. from - the third field holds the “From” information of the message to be
  57. posted.  This field cannot contain more than 79 characters.  I chose to use my
  58. own name in this field, however you may enter whatever you like.
  59.  
  60. to - the fourth field contains the “To” information of the message to be
  61. posted. This field cannot contain more than 79 characters.  I chose to use
  62. “All” in this field, again however you may enter whatever you like.
  63.  
  64. subject - The fifth field contains the “Subject” of the message to be posted.
  65. This field cannot contain more than 79 characters.  I chose to use “New files
  66. on SCORPION” in this field.
  67.  
  68. data file - pathname to the TEXT file containing information you wish to have
  69. posted in a message.  By default, this file’s name is “informant.data” and it
  70. resides in the same folder as informant.
  71.  
  72. header file - pathname to the TEXT file which contains header information you
  73. may wish to have included in the message to be posted.  By default, this
  74. file’s name is “informant.hdr” and it resides in the same folder as informant.
  75. This “header” feature is optional (see OPTIONS below).  If this field is
  76. blank, the header will be omitted.
  77.  
  78. footer file - pathname to the TEXT file which contains footer information you
  79. may wish to have included in the message to be posted.  By default, this
  80. file’s name is “informant.ftr” and it resides in the same folder as informant.
  81. This “footer” feature is optional (see OPTIONS below).  If this field is
  82. blank, the footer will be omitted.
  83.  
  84. launch next - this field specifies the program you would like to be launched
  85. after informant in the event a “launch.next” file is not found.
  86.  
  87. delete data file - if this box is checked, informant will delete the data file
  88. “informant.data” (or whatever file you have specified in the “data file”
  89. field).  You should exercise caution in the use of the data file deletion
  90. option to prevent duplicate messages from being sent on subsequent executions
  91. of informant.  I advise you to let informant delete the data file, unless
  92. there are special circumstances.
  93.  
  94. write to Tabby log - if this box is checked, informant will write information
  95. concerning it’s activities to the Tabby log.
  96.  
  97.  
  98. • HOW IT WORKS •
  99. When informant executes, it looks for the presence of an “informant.data”
  100. file. The informant.data file must have at least 3 characters in it to be
  101. considered valid.  If no valid data file is present, the program simply writes
  102. a line stating this to the Tabby log file (if you have configured it to do
  103. so), and attempts to launch the next application in the Tabby event (or the
  104. default application in the absence of a launch.next file).  However if there
  105. is a valid data file, then informant attempts to open the Generic Import and
  106. Generic Export files, and begin building the message.  When finished,
  107. informant may optionally delete the data file and will then attempt to launch
  108. the next application in the Tabby event (or the default application in the
  109. absence of a launch.next file).  If there were any problems along the way,
  110. informant tries to exit gracefully, write information in the Tabby log file
  111. (if so instructed), and launch the next application in the Tabby event (or the
  112. default application).
  113.  
  114. The message that informant creates in the Generic Import and Export files
  115. won't be delivered until the programs that deal with these respective files
  116. are next executed (TabbyNet Sendnews and your BBS’s import program).
  117.  
  118.  
  119. • IMPORTANT! •
  120. The data, header, and footer files must be plain TEXT files, no more than 90
  121. characters per line including a terminating Carriage Return.  The combined
  122. data, header, and footer can NOT consist of more than 400 lines.  Blank lines
  123. between paragraphs will contain only a single carriage return.  If you violate
  124. these format specifications you will suffer the wrath of other Fidonet sysops.
  125. I take no responsibility.  You have been warned.
  126.  
  127.  
  128. • OPTIONS •
  129. You may wish that certain information, such as special files always available
  130. on your BBS, special BBS hours, modem type and baud rates, or other special
  131. information always be included in a message posted by informant.  This is the
  132. primary purpose for the optional header and footer files.  All you need to do
  133. is create one, or both, of these TEXT files containing the information you
  134. choose, and place them in the location(s) you have specified in setting up
  135. informant.  These header and footer files are not deleted by informant, and
  136. therefore may be used again and again.
  137.  
  138.  
  139. • DISCLAIMER •
  140. informant is distributed “as is” with no warranty, express or implied with
  141. respect to the software or its quality, performance, reliability, or fitness
  142. for any purpose.  In no case will the author be held liable for direct or
  143. incidental damages resulting from defects in the software, including but not
  144. limited to any interruption of service, loss of business, anticipated profit,
  145. or other consequential damages.
  146.  
  147.  
  148. • MORE STUFF •
  149. This version of informant is no longer free.  If you use this program, please
  150. send the author $5.  The latest version of informant can always be obtained by
  151. downloading or file request (use filename informant.sit to FREQ) from SCORPION
  152. BBS (719-637-1458, FidoNet node 1:128/46) or by sending a formatted diskette
  153. and self-addressed, stamped, return envelope to:
  154.  
  155.     Chriss Koch
  156.     5325 Red Sky Dr
  157.     Colo Spgs, CO 80915
  158.  
  159. The author of informant would appreciate any comments (bug reports,
  160. enhancement requests (?), etc…) from users.  Please address all correspondence
  161. to the address above or:
  162.  
  163. GEnie: C.KOCH
  164.  
  165. SCORPION BBS
  166. 3/12/2400 24hrs
  167. (719) 637-1458
  168. FidoNet 1:128/46
  169. Sysop: Chriss Koch
  170.  
  171.  
  172. • A PLUG •
  173. Do you operate a Red Ryder Host (Second Sight) BBS?
  174.  
  175. Have you grown tired of the inflexibility of Scott Watson's file section
  176. editor, "FileEdit"?
  177.  
  178. Do you find yourself yearning for something a little less unwieldy?
  179.  
  180. Never fear, tidE is hear!
  181.  
  182. What is tidE, you ask?
  183.  
  184. tidE is a Red Ryder Host 2.x file section editor developed by Ken Beutel and
  185. myself.  tidE is a FREE program for non-commercial use and distribution by 
  186. Red Ryder Host sysops.  tidE is publicly available at fine BBSs near you.
  187.  
  188.  - or -
  189.  
  190. The latest version of tidE can always be obtained by downloading or file
  191. request (use filename tide.sit to FREQ) from SCORPION BBS (719-637-1458,
  192. FidoNet node 1:128/46) or by sending a formatted diskette and self-addressed,
  193. stamped, return envelope to the address shown above in “MORE STUFF”.
  194.  
  195. Some features of tidE include:
  196.  
  197. • Editing of multiple File Sections simultaneously (limited by RAM and
  198.   disk space).
  199. • Cut, Copy and Paste between File Sections.
  200. • Editing of file descriptions in a multiline environment (Cut, Copy and
  201.   Paste supported).
  202. • Online help.
  203. • Add new files with system and default parameters.
  204. • Multiple save features including removal of file entries marked for
  205.   deletion.
  206. • Full Mac interface support including windows, menus, mouse, cursor keys,
  207.   command key equivalents and short-cuts for commonly used commands.
  208. • Data extraction to TEXT file.
  209. • “Find” commands.
  210. • Sorting.
  211. • Printing.
  212. • And much more.
  213.